home *** CD-ROM | disk | FTP | other *** search
/ The Arsenal Files 6 / The Arsenal Files 6 (Arsenal Computer).ISO / offline / tmatc100.zip / INSTALL.TXT < prev    next >
Text File  |  1996-04-05  |  10KB  |  301 lines
  1.                      Installation Tips for Tag-O-Matic
  2.  
  3.        This file gives installing tips for the following mailers...
  4.  
  5.                               Termail / TMail
  6.  
  7.                                  BlueWave
  8.  
  9.                                   Ppoint
  10.  
  11.                                   Generic
  12.  
  13. Generic
  14. =======
  15.  
  16.  This is for all mailers not mentioned, and should work with 99% of them.
  17. First, you need to write a batch file, or edit one already in use.
  18. Let's call it REPLY.BAT, in it we'll simply put the two lines:
  19.  
  20. EDIT %1
  21. T-MATIC TAGFILE.TAG %1
  22.  
  23. Note that I'm using DOS's EDIT program for this example, but please replace
  24. it with your favourite editor. The %1 bit should expand into the name of
  25. the message file, if the mailer has half a brain. Some are terminally
  26. stupid, however, and if they don't supply the name of the message file
  27. (dropfile) then you may have to change this manually.
  28.  Rename TAGFILE.TAG to the name of your tagfile.
  29.  You could also call any other programs, before or after, such as a spell-
  30. checker or re-formatter.
  31.  
  32.  Now, load up your mailer and enter the config/setup part. Hunt through for
  33. the string that is used to call your mail program. Change this to REPLY.BAT
  34. (or whatever you decided to call the above batchfile)
  35.  
  36.  Also, while you're in config, turn off built-in taglines if available.
  37. I've not seen a mail program that has the tagline facilities of T-Matic...
  38.  
  39.  Try it out, it should work Ok.
  40.  
  41. If your mailer uses the JAM message base format, then T-Matic can steal all
  42. the taglines in all your echo's in one command. Please see the docs for
  43. more details on this.
  44.  
  45. Text Reformatting
  46. -----------------
  47.  
  48. If your mailer has provision for calling a utility before editing the
  49. message, change this to:
  50.  
  51. T-MATIC /T (messagefile)
  52.  
  53. Replace (messagefile) with the macro or filename of the message to be
  54. formatted.
  55.  
  56. If it doesn't have provision, then create a batchfile that runs T-MATIC /T
  57. before the editor.
  58.  
  59. ie.
  60.  
  61. ---REPLY.BAT---
  62. T-MATIC /T %1
  63. EDIT %1
  64. ---------------
  65.  
  66. Ppoint
  67. ======
  68.  
  69. (Not sure of the versions, but if it doesn't work, try again with Generic)
  70.  
  71. Ppoint allows for a spell-checker to be run on the finished message, which
  72. is great!  Simply change the filename it asks for to:
  73.  
  74. T-MATIC TAGLINES.TAG
  75.  
  76. (I think, but I'm not sure, that Ppoint supplies the message filename
  77. afterwards. If not, include that, or follow Generic setup)
  78.  
  79. Replace TAGLINES.TAG with the filename of your tagfile.
  80.  
  81. Turn off Ppoint's taglines. Very messy and limited, IMO :)
  82.  
  83. Stealing
  84. --------
  85. IIRC, Ppoint uses it's own format for storing messages, and it's fairly
  86. simple. Mass-stealing can be accomplished by writing a small batch file
  87. that calls T-Matic /S on every file in the echo directory.
  88.  
  89. BlueWave
  90. ========
  91.  
  92. The king of Off-Line, non-pointing software...
  93.  
  94. Bluewave has good tag-support built-in, but it's slow and not as fully-
  95. featured as T-Matic. It allows for John Hancock as an external tag-util,
  96. but for no others (IIRC). You'll have to set up T-matic with a batch file,
  97. as outlined in Generic.
  98.  
  99. Keep the tagfile filename the same, then you can adopt tags to the tagfile
  100. from within BlueWave.
  101.  
  102.  
  103. Termail
  104. =======
  105.  
  106. The king of pointing software...
  107.  
  108. (NB, the 1-key adoption routine only works for version 3.0 of Termail as
  109. far as I know. I don't think version 1.5 has support for external
  110. utilities. This may also apply to the  BeforeEdit string. If so, a batchfile may
  111. be the answer.)
  112.  
  113. T-Matic has been updated with a strong bias towards Termail, cos it's what
  114. I use and I quite like it.
  115.  
  116. Basic
  117. -----
  118. Anyway, for basic usage, edit TM.CFG and search through until you find the
  119. following.
  120.  
  121. ---------------
  122. %
  123. % Run any external program after you have written or changed a message.
  124. % This could be a batchfile that runs several programs (such as TagDude
  125. % or a spell-checker) if you want everything to to look perfectly.
  126. % !GROUP will insert the current group name of the area in uppercased
  127. % letters: INTER, GERMAN etc.
  128. %
  129.  
  130. There is a list of commented-out AfterEdit strings (including one for Tag-
  131. Dude, urgh!) Comment out any that might be there, and add,  or amend one,
  132. to read
  133.  
  134. AfterEdit  T-MATIC TAGLINES.TAG TM.MSG
  135.  
  136. ---------------
  137. (Replace TAGLINES.TAG with the name of your tagfile)
  138.  
  139.  This will call T-Matic with the tagfile: TAGLINES.TAG and will run
  140. automatically whenever you edit a message.
  141.  
  142. Personalised Taglines / sigs
  143. ----------------------------
  144.  
  145. Now, you need to make some changes to  your template so that when the message is
  146. saved by the mail editor, it puts the  person's  name on the very first line. T-
  147. Matic reads this line, and deletes it from the message. If the first word is NOT
  148. "~NAME" then T-Matic will not delete that line, although it will attempt to take
  149. the name from the line anyway. It  will  print  a warning, but won't abort. This
  150. may make any personalised tags incorrect, so keep your eyes peeled?
  151.  
  152. So, if your template contained the line:
  153.  
  154. MsgStart    Howdy @F!
  155.  
  156. Change it to:
  157.  
  158. MsgStart    ~NAME @F @L@CRHowdy @F!
  159.  
  160. (~NAME First name, last name, new line, normal greeting.)
  161.  
  162.  
  163. Seperate Tagfiles and Sigfilesets
  164. ---------------------------------
  165.  
  166. With version 8.4, T-Matic can now be run before the editor to correctly
  167. set your tagfile and sigfile for that group.
  168. A new file is supplied, T-MATIC.TMP, a sample template file for this feature.
  169. Have a look at it, it's fairly self-explanatory.
  170. Edit it in the format:
  171.  
  172. Groupname (Max. 8 chars)   SigfileSet   Tagfile Comment
  173.  
  174. Eg:
  175.  
  176. %─Group┬─Sigfiles──┬─────Tagfile─────────────────┬──Comment (Unused)─────────┐
  177. B_BAR   BAR-SIG     BARNET.TAG                    BarNet from BackYard
  178. S_FIDO  SIGFILE     TAGS.BW                       Fidonet from Satellite
  179.  
  180. The first is the name of the group. This MUST be in capital letters, as Termail
  181. will export it that way.
  182.  
  183. The second is the filename (Note, no extension - allowing for random sigfiles
  184. means that the numerical extension (1 to the limit set in Setup) is added
  185. automatically, along with the "." seperator.
  186.  
  187. The third is the name of the tagfile for that group.
  188.  
  189. The forth is simply a comment so you can remember which is which.
  190.  
  191. Now, you must again edit TM.CFG. Hunt through for the BeforeEdit string.
  192.  
  193. Change this to:
  194.  
  195. BeforeEdit    T-MATIC /G !GROUP
  196.  
  197. T-Matic will search the template file, T-MATIC.TMP for a match to the supplied
  198. group. If it finds it, it will create a small file; T-MATIC.DIT containing the
  199. new sigfileSet and tagfile names. This will be loaded when T-Matic is run after
  200. the message and will default to the new names, over-writing any supplied tagfile
  201. on the command line. T-MATIC.DIT is then deleted.
  202. If a match isn't made, it will resort to the given tagfile supplied on the
  203. command-line.
  204.  
  205.  
  206. Text reformatting
  207. -----------------
  208.  
  209. T-Matic /T (reformat) should be run BEFORE the message is edited, just in
  210. case it screws it up. It can be run afterwards, but it might reformat bits
  211. you didn't want it to touch. For some  reason, the !MSG macro is unreliable when
  212. used in BeforeEdit, so the full filename of  the dropfile has to be entered. For
  213. Termail 1.5 this is TMAIL.MSG, and for 3.0 it is TM.MSG.
  214. So, change the "BeforeEdit" string in TM.CFG to
  215.  
  216. BeforeEdit      T-MATIC /T TM.MSG  (or TMAIL.MSG if using 1.5)
  217.  
  218. It will reformat the message, to no wider than the right margin set in
  219. T-Matic's Setup. (See entry in T-MATIC.DOC for more info)
  220.  
  221.  
  222. Text Reformatting AND Group Macros
  223. ----------------------------------
  224. Becuase both of these options need to be run prior to editing the message,
  225. and because there's only one BeforeEdit string in Termail, you'll need to
  226. write a small batch file that calls both of them. I'll call it BEFORE.BAT
  227.  
  228. ---BEFORE.BAT---
  229. T-MATIC /G %1
  230. T-MATIC /T TM.MSG
  231. ----------------
  232.  
  233. Edit the BeforeEdit string in TM.CFG to read:
  234.  
  235. BeforeEdit      BEFORE.BAT !GROUP
  236.  
  237.  
  238. Auto Tag-Adopt for Termail
  239. --------------------------
  240. Nifty little feature this. Works similarly to BlueWave's adopt-tag key
  241. (ALT+A). Since TerMail allows for external utilities, then it's fairly
  242. simple to put this into effect.
  243.  
  244.  Edit TM.CFG.
  245.  
  246.  Scroll, or search through until you find this bit:
  247. %
  248. % External utilities which can be run directly from TerMail by pressing
  249. % Shift F1..F12.  Press F2 to view all available external utilities and
  250. % select the one to run.
  251. %
  252.  
  253.  Now, edit one of the twelve selections. For this example, I'll use
  254. SHIFT + F1
  255.  
  256. %          |--|  |--------------------------------------|
  257. ShiftF1    Adpt  T-MATIC /S TAGS.BW !MSG
  258.  
  259. NB. TAGS.BW should be replaced with the filename of your tagfile.
  260. NB2. You can add !W at the end of this to pause, as it flashes past
  261. quite quickly.
  262.  
  263. This is an excerpt from my TM.CFG:
  264.  
  265. %          Desc  Utility
  266. %          |--|  |--------------------------------------|
  267. ShiftF1    Adpt  T-MATIC /S TAGS.BW !MSG !W
  268.  
  269. ShiftF3    Manl  T-MATIC /S TAGS.BW
  270. ShiftF4    Dupe  T-MATIC /D TAGS.BW
  271. ShiftF5    JAMs  T-MATIC /J TAGS.BW \TERM\TERMAIL\ECHO
  272.  
  273. Shift F1 adopts the tagline from the current message.
  274. Shift F3 Will run T-Matic in manual steal mode. This will prompt you for
  275.      a tagline, which you would type in and it's then appended to your tagfile.
  276. Shift F4 Makes T-Matic dupe-check the tagfile.
  277. Shift F5 Runs T-Matic  on  JAM  steal  mode,  and  nicks  all  the tags from the
  278.      \TERM\TERMAIL\ECHO jambase directory.
  279.  
  280. Now save TM.CFG and re-run Termail. When you press SHIFT + F1, Termail
  281. will shell out and call T-Matic who will search the file for a tagline.
  282. If it finds it, it will compare it against all the tags in your tagfile
  283. (if dupe is configured in Setup) If it doesn't find a match, it will then append
  284. the tagline to the end of your tagfile. Simple!
  285.  
  286. The file can be as large as you wish. If you wanted to nick all the tags
  287. in an specific echo, then it's easy!
  288. (From Termail)
  289. 1. Mark every message.
  290. 2. Press 'W' to write the messages.
  291. 3. Write to file, all marked files, give it a unique filename. Say "ALLMSGS"
  292. 4. Shell to DOS.
  293. 5. Type T-MATIC /S TAGS.BW ALLMSGS (Or you could assign this to a key)
  294.  
  295. T-Matic will then scan through the entire file and nick every tag it finds,
  296. and check them against the existing tagfile for dupes.
  297.  
  298. If you want to scan more than one echo, then please see T-MATIC.DOC for the
  299. information on JAM steal.
  300.  
  301.